home *** CD-ROM | disk | FTP | other *** search
/ BMUG Revelations / BMUG Revelations.toast / Utilities / Network / QUE / Read Me
Text File  |  1991-12-28  |  8KB  |  207 lines
  1. QueTM
  2. QuickMail–UNIX Exchange
  3. Version 1.2, October 1989
  4.  
  5. Rob Kassel and Mike McCandless
  6. M.I.T. Spoken Language Systems Group
  7. 545 Technology Square, NE43-646
  8. Cambridge, MA 02139
  9.  
  10. Copyright © 1989 Rob Kassel, Mike McCandless and the Massachusetts Institute of 
  11. Technology
  12.  
  13. Permission to use, copy, modify, and distribute this software and its documentation for 
  14. any purpose without fee is hereby granted, provided that the above copyright notice 
  15. appear in all copies and that both that copyright notice and this permission notice appear 
  16. in supporting documentation, and that the name of M.I.T. not be used in advertising or 
  17. publicity pertaining to distribution of the software without specific, written prior 
  18. permission.  The authors and M.I.T. make no representations about the suitability of this 
  19. software for any purpose.  It is provided “as is” without express or implied warranty.
  20.  
  21. Que is a trademark of the Massachusetts Institute of Technology
  22. QuickMail, QuickMail Administrator, and QM-Serial Bridge are trademarks of CE Software, 
  23. Inc.
  24. Sun4 and SunOS are trademarks of Sun Microsystems, Inc.
  25. UNIX is a registered trademark of AT&T Bell Laboratories.
  26.  
  27.  
  28. Text added or changed since the last release is italicized.
  29.  
  30. What is Que?
  31. Que is a simple system for transferring mail between QuickMail and 
  32. a UNIX host.  It works with either the Telecommunications or QM-
  33. Serial bridge.  We plan to support a direct network connection in the 
  34. future.
  35.  
  36. Que was developed and tested with a Sun4 under SunOS 4.0.  We 
  37. expect it to be fairly portable.  Please tell us about your installation 
  38. experiences so that other may benefit.
  39.  
  40. Que is free!  It's our way of saying thanks to all the people who have 
  41. developed the free software we use.
  42.  
  43. Limitations
  44. Que currently does not transfer message enclosures, however we do 
  45. plan on supporting them.  QuickMail, and so Que, currently limits 
  46. special addresses to 114 characters.  All other restrictions imposed 
  47. by QuickMail apply.
  48.  
  49. If you discover bugs in Que, have suggestions, or would just like to 
  50. say “Hello,” please send mail to bug-que@goldilocks.lcs.mit.edu.
  51.  
  52. Distribution
  53. You can obtain the latest Que release from the info-mac archives on 
  54. sumex-aim.stanford.edu.  If you would prefer it and can provide us 
  55. with an internet mail address, we will add you to a mailing list to 
  56. receive new versions directly.  Please send inquiries to the bug-que 
  57. address listed above.
  58.  
  59. Installing Que
  60. You must be a superuser to install Que.  This document assumes that 
  61. you have the system administration knowledge commensurate with 
  62. superuser access.  Please read all of the directions before you begin 
  63. installation.
  64.  
  65. Basic UNIX Installation
  66. First you will install the files common to all of the maildrops on 
  67. your host:
  68. •    Create a new group, “quesers”, and add the daemon user to 
  69. it.
  70.  
  71. •    Create the directory “/usr/maildrops”.  Its owner, group, 
  72. and protection will be set automatically later.
  73.  
  74. •    Transfer the files in Que’s “Basic” folder to 
  75. /usr/maildrops.
  76.  
  77. •    Connect to /usr/maildrops and type “source quemake” to 
  78. compile Que’s files and set proper protections.
  79.  
  80. Maildrop Installation
  81. Que transfers mail between your UNIX host and QuickMail through a 
  82. maildrop.  A maildrop is a UNIX directory and an account to access 
  83. that directory.  Each QuickMail bridge mailcenter connecting to a 
  84. UNIX host must have its own maildrop on that host.  You may have 
  85. multiple maildrops on a host.  We name each maildrop after an 
  86. associated online mailcenter, however a single maildrop can serve 
  87. multiple online mail centers.
  88.  
  89. For each maildrop you wish to create:
  90. •    Create a user for the maildrop with membership in the 
  91. group quesers and shell “csh”.
  92.  
  93. •    Make a home directory for the user under /usr/maildrops 
  94. with group quesers.  The name of the directory will be the 
  95. name of the maildrop.   Set the directory's protection to 730.
  96.  
  97. •    Transfer the files in Que’s “maildrops” folder to the 
  98. maildrop directory.
  99.  
  100. •    Make the maildrop’s user a trusted sendmail user by editing 
  101. /etc/sendmail.cf.
  102.  
  103. User Alias Installation
  104. Your UNIX machine is instructed to place incoming messages into the 
  105. appropriate maildrop through sendmail’s aliases file (typically in 
  106. /usr/lib).  Each user’s mail which is to be sent to a maildrop is piped 
  107. through quemail.  It takes two arguments, one flagged by -d to 
  108. indicate the maildrop’s name and the other flagged by -u to indicate 
  109. the user’s QuickMail name.  For example, if you had a user named Joe 
  110. in the MIT maildrop you might include a line like this:
  111.  
  112. joe: "|/usr/maildrops/quemail -d MIT -u 'Joe'"
  113.  
  114. in the aliases file.
  115.  
  116. QuickMail allows addresses to contain spaces.  Most other mailers do 
  117. not.  Que maps spaces to underscores when sending a message.  Thus 
  118. the address of the QuickMail user “Joe Smith” will be “Joe_Smith” 
  119. on your UNIX host.
  120.  
  121. In order to handle returned mail, every user which can send mail 
  122. through a Que mailcenter must be able to receive mail through a Que 
  123. mailcenter on the same host.  Mail will not be sent if the reply 
  124. address cannot be validated first.
  125.  
  126. Que includes a program, quealias, to speed the installation of new 
  127. maildrops.  To use it
  128.  
  129. •    Use QuickMail Administrator's “Export” command to make a 
  130. file containing the names of a mailcenter’s users.  Be sure to 
  131. check the “Include Passwords” checkbox.
  132.  
  133. •    Transfer the resulting file to your UNIX host.
  134.  
  135. •    Run /usr/maildrops/quealias on the file.  This will produce 
  136. a file with “.al” appended to the name containing appropriate 
  137. text for the aliases file.  It assumes the user’s maildrop has 
  138. the same name as the user’s mailcenter.
  139.  
  140. Don’t forget to run newaliases after editing the aliases file.
  141.  
  142. Mailcenter Installation
  143. The final step in installing Que is to create the bridge mailcenters:
  144.  
  145. •    Copy the contents of Que’s “Bridge” folder into your 
  146. QuickMail Administrator’s “QA” folder.
  147.  
  148. •    Create the bridge mailcenter as directed in the QuickMail 
  149. documentation.  Use the maildrop’s account as the 
  150. “Commercial service account #” and its password as the 
  151. “Commercial service password”.  Select the Que script for 
  152. the bridge.
  153.  
  154. The script provided is meant for connecting to a host directly.  If 
  155. you must pass through an intermediary such as a modem pool, you 
  156. will need to modify the script first.  Some comments in the script 
  157. show you where to do this.
  158.  
  159. You have completed the installation process.
  160.  
  161. Using Que
  162. Through Que you can send mail to any address your UNIX host can 
  163. send to.  Que uses the “address” portion of a special address as the 
  164. destination.  Type the address there just as you would on your UNIX 
  165. host.  Do not insert any carriage returns.  Naturally you can place 
  166. these special addresses into a QuickMail directory to avoid retyping 
  167. them.
  168.  
  169. QuickMail’s reply feature is based on a message’s “From” address.  
  170. On incoming mail, Que places an appropriate address in this slot for 
  171. you.  Enough of the message’s original header is retained to 
  172. determine other addresses you may be interested in. Que also 
  173. attempts to parse out a personal name for the sender of the 
  174. message.
  175.  
  176. Que 1.1 Release Notes
  177. Version 1.1 fixed problems with parsing a message’s header.   Que 
  178. was modified to use the Reply-to: addresses if there is one as the 
  179. QuickMail “From” address.  This made replying to the message work 
  180. properly.   Que was also modified to recognize personal names 
  181. included in a comment as is used by many UNIX systems.  
  182. Additionally, the header parsing was made more robust.
  183.  
  184. Que 1.2 Release Notes
  185. Version 1.2 fixes a problem with quotation marks in addresses.  It 
  186. also adds a feature to split-up long messages.
  187.  
  188. QuickMail Administrator reads an entire incoming message into 
  189. memory before parsing the header and sending it to the mailcenter.  
  190. As a result,  very long messages would crash the administrator by 
  191. filling memory.  Que now includes a variable in mail.h, MAXMSGLENGTH, 
  192. to limit the size of incoming messages;  Longer messages are broken 
  193. into two or more parts.  The variable is initially set to 20,000 so as 
  194. to avoid QuickMail placing text in the message’s enclosure as well.
  195.  
  196. Updating to version 1.2 from 1.1 requires that you:
  197.  
  198. •    Login to your UNIX host as superuser.
  199.  
  200. •    Transfer the files in Que’s “Basic” folder to 
  201. /usr/maildrops.
  202.  
  203. •    Connect to /usr/maildrops and type “source quemake” to 
  204. compile Que’s files and set proper protections.
  205.  
  206.  
  207.